package com.probiz.estore.catalog.service;

import java.util.List;
import java.util.Map;

import net.sf.json.JSONArray;

import com.probiz.estore.catalog.model.ProductCategoryFullyModel;
import com.probiz.estore.catalog.model.ProductCategorySearchCriteria;
import com.probiz.estore.common.model.catalog.ProductCategory;
import com.probiz.estore.core.search.SearchCriteria;

/**
 * Manager interface for ProductCategory, responsible for business processing, and communicate between web and persistence layer.
 *
 */
public interface ProductCategoryManager extends BaseCategoryManager<ProductCategory> {
	/* =========================start:自定义方法=========================================== */
	/**
	 * 获取指定目录编码的目录
	 * @param categoryCode 目录编码
	 * @return 包含该目录编码的目录实体
	 */
	public ProductCategory getCategoryByCode(String categoryCode);
	/**
	 * 获取指定目录名称的目录
	 * @param name 目录名称
	 * @return 包含该目录名称的目录实体列表
	 */
	public List<ProductCategory> getCategoryByName(String name);
	
	/**
	 * 获取指定目录名称和父级的目录
	 * @param name 目录名称
	 * @return 包含该目录名称的目录实体列表
	 */
	public List<ProductCategory> getCategoryByNameAndParent(String name, Integer parentId);
	/**
	 * 根据上级目录id和目录名称找寻目录
	 * @param parentCategoryId
	 * @param categoryName
	 * @return
	 */
	public List<ProductCategory> listCategoryByParentIdAndName(Integer parentCategoryId, String categoryName);
	
	/**
    * 根据目录编码找出目录个数，但该目录的不能是参数id所指定的目录
    *
    * @param categoryCode 目录编码
    * @param categoryId 目录id
    * @return 个数
    */
    public Long getSizeByCategoryCodeByNotCategoryId(String categoryCode,Integer categoryId);
	/**
	 * 完全保存方法
	 * @param productCategoryFullyModel 自定义的完整product model
	 * @return 返回信息 
	 */
	public Map<String, Object> saveFully(ProductCategoryFullyModel productCategoryFullyModel);
	/**
	 * 商品导入保存，只用于导入
	 * @param customer
	 * @return
	 */
	public ProductCategory saveFullyForImport(ProductCategory category);
	/**
	 * 完全删除方法
	 * @param entity 要删除的产品目录实体
	 * @return 返回信息 
	 */
	public Map<String, Object> deleteFully(ProductCategory entity);
	/**
	 * 搜索产品目录
	 * @param productCategorySearchCriteria 自定义的搜索条件
	 * @param searchCriteria 分页查询条件
	 * @return 搜索结果列表
	 */
	public List<ProductCategory> searchByCriteria(ProductCategorySearchCriteria productCategorySearchCriteria, SearchCriteria searchCriteria);
	/**
	 * 将产品目录列表转换为JSONArray对象
	 * @param categoryList 产品目录List对象
	 * @return 产品目录JSONArray对象
	 */
	public JSONArray convertListToJSONArray(List<ProductCategory> categoryList);
	/**
	 * 根据fieldName改变产品目录对应field(itemCount、activeItemCount)的值。count为改变数量，可以为正，也可以为负。
	 * @param productCategoryId 产品目录id
	 * @param fieldName 对象的field name
	 * @param count 改变数量
	 */
	public void updateCountField(Integer productCategoryId, String fieldName,Integer count);
	/**
	 * 增加一个产品数量
	 * @param productCategoryId 产品目录id
	 */
	public void doIncreaseOneItemCount(Integer productCategoryId);
	/**
	 * 增加一个激活商品数量
	 * @param productCategoryId  商品目录id
	 */
	public void doIncreaseOneActiveItemCount(Integer productCategoryId);
	/**
	 * 减少一个商品数量
	 * @param productCategoryId  商品目录id
	 */
	public void doDecreaseOneItemCount(Integer productCategoryId);
	/**
	 * 减少一个激活商品数量
	 * @param productCategoryId  商品目录id
	 */
	public void doDecreaseOneActiveItemCount(Integer productCategoryId);
	
	/**
    * 获得所有目录的编码列表
    * @return 编码列表
    */
   public List<String> getAllProductCategoryCodes();
   
   /**
	 * 获得目录的所有父目录id
	 * @param childCategoryId 
	 * @return
	 */
	public List<Integer> getAllParentCategoryId(Integer childCategoryId);
	
	
	
	/* =========================end:自定义方法=========================================== */

	/* =========================start:前台自定义方法=========================================== */
	/**
	 * 根据前台uri获得目录id
	 * @param uri 前台uri
	 * @return 目录id
	 */
	public Integer getCategoryIdByUri(String uri);
	/**
	 * 根据目录id获得前台uri
	 * @param categoryId 目录id
	 * @return 前台uri
	 */
	public String getUriByCategoryId(Integer categoryId);
	/**
	 * 获取导航目录，即获得上级目录和自身目录，不包括根目录
	 * @param categoryId 目录id
	 * @return 导航目录。例如 诺基亚的导航目录是[通讯设备，手机]
	 */
	public List<ProductCategory> getNavigationCategories(Integer categoryId);
	/* =========================end:前台自定义方法=========================================== */
}
